home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmForm.z / XmForm
Encoding:
Text File  |  2002-10-03  |  67.7 KB  |  925 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmFFFFoooorrrrmmmm - The Form widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/Form.h>
  13.  
  14.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  15.           This page documents Motif 2.1.
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           Form is a container widget with no input semantics of its
  19.           own.  Constraints are placed on children of the Form to
  20.           define attachments for each of the child's four sides.
  21.           These attachments can be to the Form, to another child
  22.           widget or gadget, to a relative position within the Form, or
  23.           to the initial position of the child.  The attachments
  24.           determine the layout behavior of the Form when resizing
  25.           occurs.
  26.  
  27.           The default value for XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is the value of
  28.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn.
  29.  
  30.           Following are some important considerations in using a Form:
  31.  
  32.              +o  Every child must have an attachment on either the left
  33.                 or the right.  If initialization or XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss leaves
  34.                 a widget without such an attachment, the result
  35.                 depends upon the value of XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg.
  36.  
  37.                     If XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg is False, the child is
  38.                     given an XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM and an
  39.                     XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt equal to its current _x value.
  40.  
  41.                     If XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg is True, the child is
  42.                     given an XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
  43.                     and an XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn proportional to the current
  44.                     _x value divided by the width of the Form.
  45.  
  46.                     In either case, if the child has not been
  47.                     previously given an _xvalue, its _x value is taken
  48.                     to be 0 (zero), which places the child at the left
  49.                     side of the Form.
  50.  
  51.              +o  If you want to create a child without any attachments,
  52.                 and then later (for example, after creating and
  53.                 managing it, but before realizing it) give it a right
  54.                 attachment through XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss, you must set its
  55.                 XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE at the same time.
  56.  
  57.              +o  The XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee resource controls only whether a
  58.                 geometry request by the child will be granted.  It has
  59.                 no effect on whether the child's size can be changed
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                 because of changes in geometry of the Form or of other
  75.                 children.
  76.  
  77.              +o  Every child has a preferred width, based on geometry
  78.                 requests it makes (whether they are granted or not).
  79.  
  80.              +o  If a child has attachments on both the left and the
  81.                 right sides, its size is completely controlled by the
  82.                 Form.  It can be shrunk below its preferred width or
  83.                 enlarged above it, if necessary, due to other
  84.                 constraints.  In addition, the child's geometry
  85.                 requests to change its own width may be refused.
  86.  
  87.              +o  If a child has attachments on only its left or right
  88.                 side, it will always be at its preferred width (if
  89.                 resizable, otherwise at is current width).  This may
  90.                 cause it to be clipped by the Form or by other
  91.                 children.
  92.  
  93.              +o  If a child's left (or right) attachment is set to
  94.                 XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF, its corresponding left (or right)
  95.                 offset is forced to 0 (zero).  The attachment is then
  96.                 changed to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN, with a position that
  97.                 corresponds to the _x value of the child's left (or
  98.                 right) edge.  To fix the position of a side at a
  99.                 specific _x value, use XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM or
  100.                 XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM with the _xvalue as the left (or
  101.                 right) offset.
  102.  
  103.              +o  Unmapping a child has no effect on the Form except
  104.                 that the child is not mapped.
  105.  
  106.              +o  Unmanaging a child unmaps it.  If no other child is
  107.                 attached to it, or if all children attached to it and
  108.                 all children recursively attached to them are also all
  109.                 unmanaged, all of those children are treated as if
  110.                 they did not exist in determining the size of the
  111.                 Form.
  112.  
  113.              +o  When using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss to change the XXXXmmmmNNNNxxxx resource of
  114.                 a child, you must simultaneously set its left
  115.                 attachment to either XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF or XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE.
  116.                 Otherwise, the request is not granted.  If
  117.                 XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee is False, the request is granted only if
  118.                 the child's size can remain the same.
  119.  
  120.              +o  A left (or right) attachment of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT, where
  121.                 XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt (or XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt) is NULL, acts like
  122.                 an attachment of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM.
  123.  
  124.              +o  If an attachment is made to a widget that is not a
  125.                 child of the Form, but an ancestor of the widget is a
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                 child of the Form, the attachment is made to the
  141.                 ancestor.
  142.  
  143.           All these considerations are true of top and bottom
  144.           attachments as well, with top acting like left, bottom
  145.           acting like right, _y acting like _x, and height acting like
  146.           width.
  147.  
  148.         CCCCllllaaaasssssssseeeessss
  149.           Form inherits behavior, resources, and traits from CCCCoooorrrreeee,
  150.           CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, and XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd.
  151.  
  152.           The class pointer is _x_m_F_o_r_m_W_i_d_g_e_t_C_l_a_s_s.
  153.  
  154.           The class name is XXXXmmmmFFFFoooorrrrmmmm.
  155.  
  156.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  157.           The following table defines a set of widget resources used
  158.           by the programmer to specify data. The programmer can also
  159.           set the resource values for the inherited classes to set
  160.           attributes for this widget.  To reference a resource by name
  161.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  162.           prefix and use the remaining letters.  To specify one of the
  163.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssssfile, remove
  164.           the XXXXmmmm prefix and use the remaining letters (in either
  165.           lowercase or uppercase, but include any underscores between
  166.           words). The codes in the access column indicate if the given
  167.           resource can be set at creation time (C), set by using
  168.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss(S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  169.           not applicable (N/A).
  170.  
  171.                                      XXXXmmmmFFFFoooorrrrmmmm RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  172.           NNNNaaaammmmeeee                   CCCCllllaaaassssssss                  TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  173.           XmNfractionBase        XmCMaxValue            int         100       CSG
  174.           XmNhorizontalSpacing   XmCSpacing             Dimension   0         CSG
  175.           XmNrubberPositioning   XmCRubberPositioning   Boolean     False     CSG
  176.           XmNverticalSpacing     XmCSpacing             Dimension   0         CSG
  177.  
  178.           XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee
  179.                     Specifies the denominator used in calculating the
  180.                     relative position of a child widget using
  181.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN constraints.  The value must not
  182.                     be 0 (zero).
  183.  
  184.                     If the value of a child's XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt (or
  185.                     XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt) is XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN, the
  186.                     position of the left (or right) side of the child
  187.                     is relative to the left side of the Form and is a
  188.                     fraction of the width of the Form.  This fraction
  189.                     is the value of the child's XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn (or
  190.                     XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn) resource divided by the value of
  191.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     If the value of a child's XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt (or
  207.                     XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt) is XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN, the
  208.                     position of the top (or bottom) side of the child
  209.                     is relative to the top side of the Form and is a
  210.                     fraction of the height of the Form.  This fraction
  211.                     is the value of the child's XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn (or
  212.                     XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn) resource divided by the value
  213.                     of the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.
  214.  
  215.           XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllSSSSppppaaaacccciiiinnnngggg
  216.                     Specifies the offset for right and left
  217.                     attachments. This resource is only used if no
  218.                     offset resource is specified (when attaching to a
  219.                     widget), or if no margin resource is specified
  220.                     (when attaching to the Form).
  221.  
  222.           XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg
  223.                     Indicates the default near (left) and top
  224.                     attachments for a child of the Form.  (Note that
  225.                     whether this resource actually applies to the left
  226.                     or right side of the child and its attachment
  227.                     depends on the value of the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.)
  228.  
  229.                     The default left attachment is applied whenever
  230.                     initialization or XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss leaves the child
  231.                     without either a left or right attachment.  The
  232.                     default top attachment is applied whenever
  233.                     initialization or XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss leaves the child
  234.                     without either a top or bottom attachment.
  235.  
  236.                     If this Boolean resource is set to False,
  237.                     XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt and XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt default to
  238.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM, XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt defaults to the
  239.                     current _x value of the left side of the child, and
  240.                     XXXXmmmmNNNNttttooooppppOOOOffffffffsssseeeetttt defaults to the current _y value of
  241.                     the child.  The effect is to position the child
  242.                     according to its absolute distance from the left
  243.                     or top side of the Form.
  244.  
  245.                     If this resource is set to True, XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  246.                     and XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt default to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN,
  247.                     XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn defaults to a value proportional
  248.                     to the current _x value of the left side of the
  249.                     child divided by the width of the Form, and
  250.                     XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn defaults to a value proportional to
  251.                     the current _y value of the child divided by the
  252.                     height of the Form.  The effect is to position the
  253.                     child relative to the left or top side of the Form
  254.                     and in proportion to the width or height of the
  255.                     Form.
  256.  
  257.           XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllSSSSppppaaaacccciiiinnnngggg
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 10/3/02)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     Specifies the offset for top and bottom
  273.                     attachments. This resource is only used if no
  274.                     offset resource is specified (when attaching to a
  275.                     widget), or if no margin resource is specified
  276.                     (when attaching to the Form).
  277.  
  278.  
  279.                                            XXXXmmmmFFFFoooorrrrmmmm CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  280.                     NNNNaaaammmmeeee                  CCCCllllaaaassssssss           TTTTyyyyppppeeee            DDDDeeeeffffaaaauuuulllltttt         AAAAcccccccceeeessssssss
  281.                     XmNbottomAttachment   XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  282.                     XmNbottomOffset       XmCOffset       int             0               CSG
  283.                     XmNbottomPosition     XmCPosition     int             0               CSG
  284.                     XmNbottomWidget       XmCWidget       Widget          NULL            CSG
  285.                     XmNleftAttachment     XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  286.                     XmNleftOffset         XmCOffset       int             0               CSG
  287.                     XmNleftPosition       XmCPosition     int             0               CSG
  288.                     XmNleftWidget         XmCWidget       Widget          NULL            CSG
  289.                     XmNresizable          XmCBoolean      Boolean         True            CSG
  290.                     XmNrightAttachment    XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  291.                     XmNrightOffset        XmCOffset       int             0               CSG
  292.                     XmNrightPosition      XmCPosition     int             0               CSG
  293.                     XmNrightWidget        XmCWidget       Widget          NULL            CSG
  294.                     XmNtopAttachment      XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  295.                     XmNtopOffset          XmCOffset       int             0               CSG
  296.                     XmNtopPosition        XmCPosition     int             0               CSG
  297.                     XmNtopWidget          XmCWidget       Widget          NULL            CSG
  298.  
  299.           XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  300.                     Specifies attachment of the bottom side of the
  301.                     child. It can have the following values:
  302.  
  303.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE
  304.                               Do not attach the bottom side of the
  305.                               child.
  306.  
  307.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM
  308.                               Attach the bottom side of the child to
  309.                               the bottom side of the Form.
  310.  
  311.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM
  312.                               Attach the bottom side of the child to
  313.                               the top side of the Form.
  314.                               XXXXmmmmNNNNbbbboooottttttttoooommmmOOOOffffffffsssseeeetttt can be used to determine
  315.                               the visibility of the child.
  316.  
  317.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT
  318.                               Attach the bottom side of the child to
  319.                               the top side of the widget or gadget
  320.                               specified in the XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt
  321.                               resource.  If XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt is NULL,
  322.                               XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT is replaced by
  323.                               XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM, and the child is attached
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 10/3/02)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                               to the bottom side of the Form.
  339.  
  340.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT
  341.                               Attach the bottom side of the child to
  342.                               the bottom side of the widget or gadget
  343.                               specified in the XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt
  344.                               resource.
  345.  
  346.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
  347.                               Attach the bottom side of the child to a
  348.                               position that is relative to the top
  349.                               side of the Form and in proportion to
  350.                               the height of the Form.  This position
  351.                               is determined by the XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn
  352.                               and XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  353.  
  354.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF
  355.                               Attach the bottom side of the child to a
  356.                               position that is proportional to the
  357.                               current _y value of the bottom of the
  358.                               child divided by the height of the Form.
  359.                               This position is determined by the
  360.                               XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn and XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee
  361.                               resources.  XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn is set to
  362.                               a value proportional to the current _y
  363.                               value of the bottom of the child divided
  364.                               by the height of the Form.
  365.  
  366.           XXXXmmmmNNNNbbbboooottttttttoooommmmOOOOffffffffsssseeeetttt
  367.                     Specifies the constant offset between the bottom
  368.                     side of the child and the object to which it is
  369.                     attached.  The relationship established remains,
  370.                     regardless of any resizing operations that occur.
  371.                     When this resource is explicitly set, the value of
  372.                     XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllSSSSppppaaaacccciiiinnnnggggis ignored.
  373.  
  374.           XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn
  375.                     This resource is used to determine the position of
  376.                     the bottom side of the child when the child's
  377.                     XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.
  378.                     In this case the position of the bottom side of
  379.                     the child is relative to the top side of the Form
  380.                     and is a fraction of the height of the Form.  This
  381.                     fraction is the value of the child's
  382.                     XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnnresource divided by the value of
  383.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  384.                     child's XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  385.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's height is
  386.                     200, the position of the bottom side of the child
  387.                     is 100.
  388.  
  389.           XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 10/3/02)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     Specifies the widget or gadget to which the bottom
  405.                     side of the child is attached.  This resource is
  406.                     used if the XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt resource is set to
  407.                     either XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTTor XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  408.  
  409.                     A string-to-widget resource converter is
  410.                     automatically installed for use with this
  411.                     resource.  With this converter, the widget that is
  412.                     to be the value of the resource must exist at the
  413.                     time the widget that has the resource is created.
  414.  
  415.           XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  416.                     Specifies attachment of the near (left) side of
  417.                     the child.  (Note that whether this resource
  418.                     actually applies to the left or right side of the
  419.                     child and its attachment depends on the value of
  420.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  It can have the
  421.                     following values:
  422.  
  423.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE
  424.                               Do not attach the left side of the
  425.                               child.  If XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is also
  426.                               XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE, this value is ignored and
  427.                               the child is given a default left
  428.                               attachment.
  429.  
  430.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM
  431.                               Attach the left side of the child to the
  432.                               left side of the Form.
  433.  
  434.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM
  435.                               Attach the left side of the child to the
  436.                               right side of the Form.  XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt
  437.                               can be used to determine the visibility
  438.                               of the child.
  439.  
  440.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT
  441.                               Attach the left side of the child to the
  442.                               right side of the widget or gadget
  443.                               specified in the XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt resource.
  444.                               If XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt is NULL,
  445.                               XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT is replaced by
  446.                               XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM, and the child is attached
  447.                               to the left side of the Form.
  448.  
  449.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT
  450.                               Attach the left side of the child to the
  451.                               left side of the widget or gadget
  452.                               specified in the XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt resource.
  453.  
  454.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
  455.                               Attach the left side of the child to a
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 10/3/02)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                               position that is relative to the left
  471.                               side of the Form and in proportion to
  472.                               the width of the Form.  This position is
  473.                               determined by the XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn and
  474.                               XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  475.  
  476.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF
  477.                               Attach the left side of the child to a
  478.                               position that is proportional to the
  479.                               current _x value of the left side of the
  480.                               child divided by the width of the Form.
  481.                               This position is determined by the
  482.                               XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn and XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee
  483.                               resources.  XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn is set to a
  484.                               value proportional to the current _x
  485.                               value of the left side of the child
  486.                               divided by the width of the Form.
  487.  
  488.           XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt
  489.                     Specifies the constant offset between the near
  490.                     (left) side of the child and the object to which
  491.                     it is attached.  (Note that whether this resource
  492.                     actually applies to the left or right side of the
  493.                     child and its attachment depends on the value of
  494.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  The
  495.                     relationship established remains, regardless of
  496.                     any resizing operations that occur.  When this
  497.                     resource is explicitly set, the value of
  498.                     XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllSSSSppppaaaacccciiiinnnnggggis ignored.
  499.  
  500.           XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn
  501.                     This resource is used to determine the position of
  502.                     the near (left) side of the child when the child's
  503.                     XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.
  504.                     (Note that whether this resource actually applies
  505.                     to the left or right side of the child and its
  506.                     attachment depends on the value of the
  507.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)
  508.  
  509.                     In this case, the position of the left side of the
  510.                     child is relative to the left side of the Form and
  511.                     is a fraction of the width of the Form.  This
  512.                     fraction is the value of the child's
  513.                     XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn resource divided by the value of
  514.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  515.                     child's XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  516.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's width is
  517.                     200, the position of the left side of the child is
  518.                     100.
  519.  
  520.           XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt
  521.                     Specifies the widget or gadget to which the near
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 10/3/02)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  533.  
  534.  
  535.  
  536.                     (left) side of the child is attached.  (Note that
  537.                     whether this resource actually applies to the left
  538.                     or right side of the child and its attachment
  539.                     depends on the value of the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn
  540.                     resource.)  The XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt resource is used if
  541.                     the XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnnttttresource is set to either
  542.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTTor XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  543.  
  544.                     A string-to-widget resource converter is
  545.                     automatically installed for use with this
  546.                     resource.  With this converter, the widget that is
  547.                     to be the value of the resource must exist at the
  548.                     time the widget that has the resource is created.
  549.  
  550.           XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee
  551.                     This Boolean resource specifies whether or not a
  552.                     child's request for a new size is (conditionally)
  553.                     granted by the Form.  If this resource is set to
  554.                     True the request is granted if possible.  If this
  555.                     resource is set to False the request is always
  556.                     refused.
  557.  
  558.                     If a child has both left and right attachments,
  559.                     its width is completely controlled by the Form,
  560.                     regardless of the value of the child's
  561.                     XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee resource.  If a child has a left or
  562.                     right attachment but not both, the child's
  563.                     XXXXmmmmNNNNwwwwiiiiddddtttthhhh is used in setting its width if the value
  564.                     of the child's XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee resource is True.
  565.                     These conditions are also true for top and bottom
  566.                     attachments, with height acting like width.
  567.  
  568.           XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  569.                     Specifies attachment of the far (right) side of
  570.                     the child.  (Note that whether this resource
  571.                     actually applies to the left or right side of the
  572.                     child and its attachment depends on the value of
  573.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  It can have the
  574.                     following values:
  575.  
  576.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE
  577.                               Do not attach the right side of the
  578.                               child.
  579.  
  580.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM
  581.                               Attach the right side of the child to
  582.                               the right side of the Form.
  583.  
  584.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM
  585.                               Attach the right side of the child to
  586.                               the left side of the Form.
  587.                               XXXXmmmmNNNNrrrriiiigggghhhhttttOOOOffffffffsssseeeetttt can be used to determine
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 10/3/02)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  599.  
  600.  
  601.  
  602.                               the visibility of the child.
  603.  
  604.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT
  605.                               Attach the right side of the child to
  606.                               the left side of the widget or gadget
  607.                               specified in the XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt
  608.                               resource.  If XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt is NULL,
  609.                               XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT is replaced by
  610.                               XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM, and the child is attached
  611.                               to the right side of the Form.
  612.  
  613.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT
  614.                               Attach the right side of the child to
  615.                               the right side of the widget or gadget
  616.                               specified in the XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt
  617.                               resource.
  618.  
  619.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
  620.                               Attach the right side of the child to a
  621.                               position that is relative to the left
  622.                               side of the Form and in proportion to
  623.                               the width of the Form.  This position is
  624.                               determined by the XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn and
  625.                               XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  626.  
  627.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF
  628.                               Attach the right side of the child to a
  629.                               position that is proportional to the
  630.                               current _x value of the right side of the
  631.                               child divided by the width of the Form.
  632.                               This position is determined by the
  633.                               XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn and XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee
  634.                               resources.  XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn is set to a
  635.                               value proportional to the current _x
  636.                               value of the right side of the child
  637.                               divided by the width of the Form.
  638.  
  639.           XXXXmmmmNNNNrrrriiiigggghhhhttttOOOOffffffffsssseeeetttt
  640.                     Specifies the constant offset between the far
  641.                     (right) side of the child and the object to which
  642.                     it is attached.  (Note that whether this resource
  643.                     actually applies to the left or right side of the
  644.                     child and its attachment depends on the value of
  645.                     the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  The
  646.                     relationship established remains, regardless of
  647.                     any resizing operations that occur.  When this
  648.                     resource is explicitly set, the value of
  649.                     XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllSSSSppppaaaacccciiiinnnnggggis ignored.
  650.  
  651.           XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn
  652.                     This resource is used to determine the position of
  653.                     the far (right) side of the child when the child's
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 10/3/02)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  665.  
  666.  
  667.  
  668.                     XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.
  669.                     (Note that whether this resource actually applies
  670.                     to the left or right side of the child and its
  671.                     attachment depends on the value of the
  672.                     XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)
  673.  
  674.                     In this case the position of the right side of the
  675.                     child is relative to the left side of the Form and
  676.                     is a fraction of the width of the Form.  This
  677.                     fraction is the value of the child's
  678.                     XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn resource divided by the value of
  679.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  680.                     child's XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  681.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's width is
  682.                     200, the position of the right side of the child
  683.                     is 100.
  684.  
  685.           XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt
  686.                     Specifies the widget or gadget to which the far
  687.                     (right) side of the child is attached.  (Note that
  688.                     whether this resource actually applies to the left
  689.                     or right side of the child and its attachment
  690.                     depends on the value of the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn
  691.                     resource.)  The XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt resource is used if
  692.                     the XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt resource is set to either
  693.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTTor XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  694.  
  695.                     A string-to-widget resource converter is
  696.                     automatically installed for use with this
  697.                     resource.  With this converter, the widget that is
  698.                     to be the value of the resource must exist at the
  699.                     time the widget that has the resource is created.
  700.  
  701.           XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  702.                     Specifies attachment of the top side of the child.
  703.                     It can have following values:
  704.  
  705.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE
  706.                               Do not attach the top side of the child.
  707.                               If the XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt resource is
  708.                               also XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE, this value is
  709.                               ignored and the child is given a default
  710.                               top attachment.
  711.  
  712.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM
  713.                               Attach the top side of the child to the
  714.                               top side of the Form.
  715.  
  716.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM
  717.                               Attach the top side of the child to the
  718.                               bottom side of the Form.  XXXXmmmmNNNNttttooooppppOOOOffffffffsssseeeetttt
  719.                               can be used to determine the visibility
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 10/3/02)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  731.  
  732.  
  733.  
  734.                               of the child.
  735.  
  736.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT
  737.                               Attach the top side of the child to the
  738.                               bottom side of the widget or gadget
  739.                               specified in the XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt resource.
  740.                               If XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt is NULL, XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT
  741.                               is replaced by XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM and the
  742.                               child is attached to the top side of the
  743.                               Form.
  744.  
  745.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT
  746.                               Attach the top side of the child to the
  747.                               top side of the widget or gadget
  748.                               specified in the XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt resource.
  749.  
  750.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
  751.                               Attach the top side of the child to a
  752.                               position that is relative to the top
  753.                               side of the Form and in proportion to
  754.                               the height of the Form.  This position
  755.                               is determined by the XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn and
  756.                               XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  757.  
  758.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF
  759.                               Attach the top side of the child to a
  760.                               position that is proportional to the
  761.                               current _y value of the child divided by
  762.                               the height of the Form.  This position
  763.                               is determined by the XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn and
  764.                               XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  765.                               XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn is set to a value
  766.                               proportional to the current _y value of
  767.                               the child divided by the height of the
  768.                               Form.
  769.  
  770.           XXXXmmmmNNNNttttooooppppOOOOffffffffsssseeeetttt
  771.                     Specifies the constant offset between the top side
  772.                     of the child and the object to which it is
  773.                     attached.  The relationship established remains,
  774.                     regardless of any resizing operations that occur.
  775.                     When this resource is explicitly set, the value of
  776.                     XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllSSSSppppaaaacccciiiinnnnggggis ignored.
  777.  
  778.           XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn
  779.                     This resource is used to determine the position of
  780.                     the top side of the child when the child's
  781.                     XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.  In
  782.                     this case, the position of the top side of the
  783.                     child is relative to the top side of the Form and
  784.                     is a fraction of the height of the Form.  This
  785.                     fraction is the value of the child's
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 10/3/02)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  797.  
  798.  
  799.  
  800.                     XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnnresource divided by the value of the
  801.                     Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  802.                     child's XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  803.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's height is
  804.                     200, the position of the top side of the child is
  805.                     100.
  806.  
  807.           XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt
  808.                     Specifies the widget or gadget to which the top
  809.                     side of the child is attached.  This resource is
  810.                     used if XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to a value of
  811.                     either XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTTor XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  812.  
  813.                     A string-to-widget resource converter is
  814.                     automatically installed for use with this
  815.                     resource.  With this converter, the widget that is
  816.                     to be the value of the resource must exist at the
  817.                     time the widget that has the resource is created.
  818.  
  819.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  820.           Form inherits behavior and resources from the superclasses
  821.           described in the following tables.  For a complete
  822.           description of each resource, refer to the reference page
  823.           for that superclass.
  824.  
  825.                                       XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  826.           NNNNaaaammmmeeee                   CCCCllllaaaassssssss                  TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  827.           XmNallowOverlap        XmCAllowOverlap        Boolean          True           CSG
  828.           XmNautoUnmanage        XmCAutoUnmanage        Boolean          True           CG
  829.           XmNbuttonFontList      XmCButtonFontList      XmFontList       dynamic        CSG
  830.           XmNbuttonRenderTable   XmCButtonRenderTable   XmRenderTable    dynamic        CSG
  831.           XmNcancelButton        XmCWidget              Widget           NULL           SG
  832.           XmNdefaultButton       XmCWidget              Widget           NULL           SG
  833.           XmNdefaultPosition     XmCDefaultPosition     Boolean          True           CSG
  834.           XmNdialogStyle         XmCDialogStyle         unsigned char    dynamic        CSG
  835.           XmNdialogTitle         XmCDialogTitle         XmString         NULL           CSG
  836.           XmNfocusCallback       XmCCallback            XtCallbackList   NULL           C
  837.           XmNlabelFontList       XmCLabelFontList       XmFontList       dynamic        CSG
  838.           XmNlabelRenderTable    XmCLabelRenderTable    XmRenderTable    dynamic        CSG
  839.           XmNmapCallback         XmCCallback            XtCallbackList   NULL           C
  840.           XmNmarginHeight        XmCMarginHeight        Dimension        0              CSG
  841.           XmNmarginWidth         XmCMarginWidth         Dimension        0              CSG
  842.           XmNnoResize            XmCNoResize            Boolean          False          CSG
  843.           XmNresizePolicy        XmCResizePolicy        unsigned char    XmRESIZE_ANY   CSG
  844.           XmNshadowType          XmCShadowType          unsigned char    XmSHADOW_OUT   CSG
  845.           XmNtextFontList        XmCTextFontList        XmFontList       dynamic        CSG
  846.           XmNtextRenderTable     XmCTextRenderTable     XmRenderTable    dynamic        CSG
  847.           XmNtextTranslations    XmCTranslations        XtTranslations   NULL           C
  848.           XmNunmapCallback       XmCCallback            XtCallbackList   NULL           C
  849.  
  850.                                                 XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  851.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 10/3/02)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  863.  
  864.  
  865.  
  866.           XmNbottomShadowColor      XmCBottomShadowColor    Pixel               dynamic                CSG
  867.           XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  868.           XmNforeground             XmCForeground           Pixel               dynamic                CSG
  869.           XmNhelpCallback           XmCCallback             XtCallbackList      NULL                   C
  870.           XmNhighlightColor         XmCHighlightColor       Pixel               dynamic                CSG
  871.           XmNhighlightPixmap        XmCHighlightPixmap      Pixmap              dynamic                CSG
  872.           XmNinitialFocus           XmCInitialFocus         Widget              dynamic                CSG
  873.           XmNlayoutDirection        XmCLayoutDirection      XmDirection         dynamic                CG
  874.           XmNnavigationType         XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  875.           XmNpopupHandlerCallback   XmCCallback             XtCallbackList      NULL                   C
  876.           XmNshadowThickness        XmCShadowThickness      Dimension           dynamic                CSG
  877.           XmNstringDirection        XmCStringDirection      XmStringDirection   dynamic                CG
  878.           XmNtopShadowColor         XmCTopShadowColor       Pixel               dynamic                CSG
  879.           XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap              dynamic                CSG
  880.           XmNtraversalOn            XmCTraversalOn          Boolean             True                   CSG
  881.           XmNunitType               XmCUnitType             unsigned char       dynamic                CSG
  882.           XmNuserData               XmCUserData             XtPointer           NULL                   CSG
  883.  
  884.                                   CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  885.           NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  886.           XmNchildren         XmCReadOnly         WidgetList    NULL      G
  887.           XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  888.           XmNnumChildren      XmCReadOnly         Cardinal      0         G
  889.  
  890.                                                         CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  891.           NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  892.           XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
  893.           XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  894.           XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  895.           XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  896.           XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  897.           XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  898.           XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  899.           XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  900.           XmNdepth                        XmCDepth                        int              dynamic                CG
  901.           XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  902.           XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  903.           XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  904.           XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  905.           XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  906.           XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  907.           XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  908.           XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  909.           XmNx                            XmCPosition                     Position         0                      CSG
  910.           XmNy                            XmCPosition                     Position         0                      CSG
  911.  
  912.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  913.           XmForm inherits translations from XmBulletinBoard.
  914.  
  915.      RRRREEEELLLLAAAATTTTEEEEDDDD
  916.           CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd(3),
  917.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeFFFFoooorrrrmmmm, XXXXmmmmCCCCrrrreeeeaaaatttteeeeFFFFoooorrrrmmmmDDDDiiiiaaaalllloooogggg(3), and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3).
  918.  
  919.  
  920.  
  921.      Page 14                                         (printed 10/3/02)
  922.  
  923.  
  924.  
  925.